home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / hfs001.zip / hfs.INF (.txt) < prev    next >
OS/2 Help File  |  1996-06-27  |  16KB  |  396 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Title page ΓòÉΓòÉΓòÉ
  3.  
  4.  HFS/2
  5. A Hierarchical File System Driver for OS/2
  6. Copyright (C) 1996 by Marcus Better 
  7. Based on "MacFS", Copyright (C) 1996 by 
  8. Peter A. Dinda, George C. Necula, and Morgan Price 
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 2. Introduction ΓòÉΓòÉΓòÉ
  12.  
  13. HFS/2 is a file system driver for OS/2 which reads and writes Macintosh 
  14. diskettes. With HFS/2, a Macintosh diskette can be used seamlessly with OS/2 
  15. just as if it were an ordinary DOS diskette. At least, that is how it is 
  16. supposed to be once the rough edges get smoothed out. 
  17.  
  18. This program supports 1.4MB Macintosh diskettes formatted with the Hierarchical 
  19. File System only. Old 800k diskettes or diskettes formatted with the "flat" 
  20. file system cannot be used. In the future, it should be possible to make HFS/2 
  21. handle hard disks as well. 
  22.  
  23. Warning: This program is in an early, experimental state. It is almost 
  24. certainly lacking some important features, and may still have many bugs and 
  25. problems. You should always make backup copies of any diskettes that you use 
  26. with this program.
  27.  
  28. HFS/2 is based on MacFS, a free, portable implementation of the Macintosh 
  29. Hierarchical File System by Peter A. Dinda, George C. Necula, and Morgan Price. 
  30. The source code for MacFS is incorporated in HFS/2, slightly modified. I have 
  31. found it helpful to look at the source code of Matthieu Willm's ext2-os2 
  32. driver, and have borrowed some ideas from him. The IFS part of HFS/2 follows an 
  33. architecture for a split ring 0/ring 3 IFS described in articles by Andre 
  34. Asselin in the Electronic OS/2 Developer's Magazine. 
  35.  
  36. The latest version of HFS/2 is available on the WWW at 
  37. http://www.abc.se/~m9111/HFS. 
  38.  
  39. I hope you will find HFS/2 useful. You are welcome to send me any comments, 
  40. suggestions, bug reports and contributions. 
  41.  
  42. Marcus Better 
  43.  
  44.  Email:         Marcus.Better@abc.se 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 3. Licence and Conditions of Use ΓòÉΓòÉΓòÉ
  48.  
  49.       Licence for HFS/2 
  50.       Licence for MacFS 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 3.1. Licence for HFS/2 ΓòÉΓòÉΓòÉ
  54.  
  55. Disclaimer  This program is supplied as is. The author assumes no 
  56.             responsibility for damages which may result from the use of this 
  57.             program. 
  58.  
  59.  HFS/2 may be used and freely distributed within the limits stated below. You 
  60.  may also modify HFS/2 and incorporate it in other programs within these 
  61.  limits. 
  62.  
  63.    1. HFS/2 may be freely used for non-commercial purposes only. 
  64.  
  65.    2. If you alter HFS/2 in any way and distribute the work, then that work 
  66.       must be similarly free, and the source code must be freely available to 
  67.       the public. 
  68.  
  69.  This program incorporates MacFS, which is covered by a licence of its own. 
  70.  
  71.  HFS/2 is Copyright (C) 1996 by Marcus Better. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 3.2. Licence for MacFS ΓòÉΓòÉΓòÉ
  75.  
  76. WARNINGS
  77. --------
  78.  
  79. THIS SOURCE CODE IS NOT PUBLIC DOMAIN, FREEWARE, SHAREWARE, or "COPY-LEFTED."
  80.  
  81. THIS SOURCE CODE MAY BE FREELY DISTRIBUTED UNDER THE LIMITS SPECIFIED BELOW.
  82.  
  83. THIS SOURCE CODE HAS NO ACTUAL OR IMPLIED WARRANTY OR GUARANTEE OF ANY
  84. KIND FROM PETER A. DINDA, GEORGE C. NECULA, MORGAN PRICE, CARNEGIE MELLON
  85. UNIVERSITY, OR ANY OTHER PARTY.
  86.  
  87. THIS SOURCE CODE IS NOT SUPPORTED BY PETER A. DINDA, GEORGE C. NECULA,
  88. MORGAN PRICE, CARNEGIE MELLON UNIVERSITY, OR ANY OTHER PARTY.
  89.  
  90. To the best of our knowledge, this source code, "MacFS", is correct
  91. and suitable.  However, no warranty or guarantee of any kind, either actual
  92. or implied, is provided for this software.  Additionally, no support is
  93. provided for this software.  It is used at your own risk.
  94.  
  95. ==============================================================================
  96.  
  97. LICENSE
  98. -------
  99.  
  100. This source code, "MacFS", is
  101.  
  102.   Copyright (c) 1996 by Peter A. Dinda, George C. Necula, and Morgan Price
  103.  
  104.  
  105. Current version is available via:
  106.     http://www.cs.cmu.edu/afs/cs.cmu.edu/usr/pdinda/html/pdinda.html
  107.     ftp://ftp.cs.cmu.edu/user/pdinda
  108.  
  109. Permission is granted to distribute and freely use and extend "MacFS", or
  110. to incorporate the "MacFS" source code into other software within these
  111. limits:
  112.  
  113.    0) "MacFS" and any derivatives of "MacFS" must retain this license,
  114. display the above copyright notice when run, and include this file.
  115.  
  116.    1) "MacFS" and any derivatives of "MacFS" may only be freely used for
  117. non-commercial purposes.  If you are interested in commercial use of
  118. "MacFS", contact Peter A. Dinda (pdinda@cs.cmu.edu).
  119.  
  120.    2) "MacFS" and any derivatives of "MacFS" may not be used for military
  121. purposes.
  122.  
  123.    3) Peter A. Dinda (pdinda@cs.cmu.edu) must be notified of any
  124. derivatives of "MacFS"
  125.  
  126.  
  127. In simple terms, "MacFS" may be freely used for any non-commercial,
  128. non-military purposes.  Derivatives of "MacFS" must be similarly free
  129. and Peter A. Dinda (pdinda@cs) must be notified of their existence.
  130. Commercial use of "MacFS" and commercial derivatives of "MacFS" are NOT
  131. ALLOWED under this license.  To use "MacFS" commercially, contact
  132. Peter A. Dinda (pdinda@cs.cmu.edu) for more information.
  133.  
  134.  
  135.  
  136. Peter August Dinda                                     pdinda@cs.cmu.edu
  137. Doctoral Student, School of Computer Science, Carnegie Mellon University
  138.    http://www.cs.cmu.edu/afs/cs.cmu.edu/usr/pdinda/html/pdinda.html
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 4. Installation instructions ΓòÉΓòÉΓòÉ
  142.  
  143. The following steps describe how to install HFS/2. 
  144.  
  145.    1. Unpack the distribution archive hfsnnn.zip into a directory anywhere on 
  146.       your system. 
  147.  
  148.    2. Add the following line to the CONFIG.SYS file on your boot drive: 
  149.  
  150.             IFS=d:\path\HFS.IFS
  151.  
  152.       where d:\path\ is the path to the directory where you unpacked the files. 
  153.       The line must be located after the IFS= statement for the file system 
  154.       where HFS/2 resides, if any. 
  155.  
  156.    3. You may add the line 
  157.  
  158.             RUN=d:\path\HFS.EXE
  159.  
  160.       to the CONFIG.SYS file to have the Control Program HFS.EXE started in the 
  161.       background at boot time. This program must be activated, either in this 
  162.       way or simply by running it from an OS/2 prompt, before using HFS/2. 
  163.  
  164.    4. Optionally add the HFS/2 directory to the PATH line in CONFIG.SYS. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 5. Using HFS/2 ΓòÉΓòÉΓòÉ
  168.  
  169. HFS/2 is made up mainly of two parts: 
  170.  
  171.      the IFS, and 
  172.      the Control Program. 
  173.  
  174.  The IFS resides in the file HFS.IFS, and is loaded at boot time with a line in 
  175.  CONFIG.SYS. The Control Program resides in the file HFS.EXE. 
  176.  
  177.  In addition, the HFS/2 package contains the utilities PREPARE.EXE, SYNC.EXE 
  178.  and FSKILL.EXE. Their function is described in the following sections. 
  179.  
  180.  Here is a short summary of the steps involved in using a Macintosh diskette 
  181.  with HFS/2: 
  182.  
  183.    1. Make sure the Control Program is running. 
  184.    2. Insert the diskette into a diskette drive. We will assume this drive is 
  185.       A: for this example. 
  186.    3. If the diskette has not been prepared for use with HFS/2, prepare it with 
  187.       the command 
  188.  
  189.             PREPARE /P A:
  190.  
  191.       See the section on PREPARE for a closer description of this command. 
  192.    4. Access the files on the diskette in any way you like. 
  193.    5. Synchronize the data on the diskette by invoking 
  194.  
  195.             SYNC A:
  196.  
  197.       See the section on SYNC for further information on this command. 
  198.    6. Optionally restore the diskette with the command 
  199.  
  200.             PREPARE /R A:
  201.  
  202.    7. Remove the diskette from its drive. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 5.1. The Control Program ΓòÉΓòÉΓòÉ
  206.  
  207. The file HFS.EXE is known as the Control Program. It is the Control Program 
  208. that carries out most tasks on behalf of the file system driver. HFS.EXE can be 
  209. started either from an OS/2 prompt, or using a RUN= statement in CONFIG.SYS. 
  210. There are no command-line options for HFS.EXE. 
  211.  
  212. When the Control Program is started, it connects to the IFS and starts 
  213. processing file system requests. Macintosh volumes can be accessed only when 
  214. the Control Program is running. The Control Program will refuse to load if 
  215. another instance of the program is already running. 
  216.  
  217. Warning: If the Control Program is interrupted while a Macintosh diskette is 
  218. mounted, data may be lost and the diskette left in an inconsis